|
|
SetOutlinePreferred |
||||
| Header: | Fonts.h | Carbon status: | Supported | |
Sets the preference for whether to use bitmapped or outline fonts when both kinds of fonts are available.
void SetOutlinePreferred (
Boolean outlinePreferred
);
Specifies whether the Font Manager chooses an outline font or a bitmapped font when both are available to fill a font request. A value of TRUE indicates an outline font; a value of FALSE indicates a bitmapped font.
If you want the Font Manager to choose outline fonts over any bitmapped font counterparts, set the outlinePreferred parameter to TRUE; if you want it to choose bitmapped fonts, set the outlinePreferred parameter to FALSE.
If an outline font and a bitmapped font are both available for a font request, the default behavior for the Font Manager is to choose the bitmapped font, in order to maintain compatibility with documents that were created on computer systems on which outline fonts were not available. The SetOutlinePreferred function sets the Font Manager’s current preference for either bitmapped or outline fonts when both are available.
If only outline fonts are available, the Font Manager chooses them regardless of the setting of outlinePreferred; if only bitmapped fonts are available, they are chosen. The Font Manager chooses bitmapped versus outline fonts on a size basis, before it takes stylistic variations into account, which can lead to unexpected results.
The preference you set is valid only during the current session with your application. The outlinePreferred parameter does not set a global variable.
Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.
© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)